Skip to content

Remove PostgreSQL subchart and require external database (v4.0.0)#196

Merged
ChrisJBurns merged 3 commits intomasterfrom
removes-postgres
Oct 26, 2025
Merged

Remove PostgreSQL subchart and require external database (v4.0.0)#196
ChrisJBurns merged 3 commits intomasterfrom
removes-postgres

Conversation

@ChrisJBurns
Copy link
Copy Markdown
Contributor

@ChrisJBurns ChrisJBurns commented Oct 26, 2025

⚠️ Breaking Change ⚠️

This PR removes the bundled PostgreSQL subchart from the Pact Broker Helm chart, making this a major version bump to v4.0.0. Users must now provide their own PostgreSQL instance.

Background

Due to Bitnami's decision to discontinue free open-source Helm charts and container images, we've removed the PostgreSQL subchart dependency. After evaluation, we found no suitable drop-in replacements that match Bitnami's quality and maintenance standards.

Changes

  • Removed PostgreSQL subchart - No longer bundles PostgreSQL with the chart
  • Simplified configuration - Renamed externalDatabase to database as it's now the only option
  • Updated templates - Removed all conditional logic for PostgreSQL vs external database
  • Enhanced CI testing - Added PostgreSQL deployment to Kind cluster for testing
  • Matrix testing - Tests against PostgreSQL versions 13, 14, 15, 16, and 17
  • Migration guide - Added comprehensive guide for users upgrading

Migration Required

Users upgrading must:

  1. Deploy their own PostgreSQL instance (cloud-managed, self-hosted, or via operator)
  2. Update their values to use the new database configuration structure
  3. Migrate data from the bundled PostgreSQL if previously used

See ./docs/MIGRATION_GUIDE_v4.md for detailed upgrade instructions.

Rationale

  • Most production deployments already use managed PostgreSQL services
  • Removes maintenance burden and security concerns of bundled database
  • Aligns with cloud-native best practices of using external stateful services
  • Simplifies the chart and reduces complexity

Fixes #194

- removes subchart for postgres due to licensing changes
- cleans up old and unused tpl functions
- amends names of values to be more intuitive
- adds migration guide
- adds new CI tests alongside a test postgres database in pipeline

Signed-off-by: ChrisJBurns <29541485+ChrisJBurns@users.noreply.github.com>
Signed-off-by: ChrisJBurns <29541485+ChrisJBurns@users.noreply.github.com>
@ChrisJBurns ChrisJBurns changed the title DRAFT: removes postgres from pact chart Remove PostgreSQL subchart and require external database (v4.0.0) Oct 26, 2025
@ChrisJBurns ChrisJBurns merged commit 033bb27 into master Oct 26, 2025
7 checks passed
@ChrisJBurns ChrisJBurns deleted the removes-postgres branch October 26, 2025 20:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Remove Postgres Feature from Pact Broker Chart

1 participant